GitHub - fyne-io/fyne: Cross platform GUI toolkit in Go... https://github.com/fyne-io/fyne 


A fyne-io /fyne ' Public 
Cross platform GUI toolkit in Go inspired by Material Design 


E fyne.io/ 
sja View license 
Y 24k stars Y 1.3kforks PY Branches (O) Tags 4 Activity 


A notifications 


YY Star > 


<> Code  () Issues 645 12 Pull requests 23 (Y) Discussions  () Actions  [H Projects 2 DO Wiki  () Security | Insights 


1 de 9 17/7/24, 23:34 


GitHub - fyne-io/fyne: Cross platform GUI toolkit in Go... 


2 de 9 


P master + 


Y 8 Branches () 98 Tags 


pP. OS A. Go to file 


2 andydotxyz Merge branch 'master' into develop Em y 


9590)0/10.)00 1/00 0000/10/00 .00 00 000U.UMREFFEUEEUCE EXE E FE xqrrErotr.a 


.github 

app 

canvas 

cmd 

container 

data 

dialog 

driver 

img 

internal 

lang 

layout 

storage 

test 

theme 
tools/playground 
widget 

-gitignore 
.godocdown.import 
AUTHORS 
CHANGELOG.md 
CODE_OF_CONDUCT.md 
CONTRIBUTING.md 
LICENSE 
README.md 
SECURITY.md 
animation.go 
animation_test.go 
app.go 
app_test.go 
canvas.go 
canvasobject.go 
clipboard.go 
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Merge branch 'master' into develop 

Fix build tags for mobile simulation on darwin 
replace usage of deprecated color functions ... 
Merge pull request 114986 from andydotxyz/fi... 
Expand doc 

Merge pull request ++4808 from Dorbmon/4807 
Remove some code duplication 

Merge pull request 114858 from dweymouth/r... 
Up to date screenshots 

Remove unused code 


Merge branch 'develop' into fix/textoptimisati... 


Merge pull request 114823 from dweymouth/c... 


Fix some comments 

Merge pull request 114839 from dweymouth/r... 
Merge branch 'master' into develop 

Fix usage of deprecated theme APIs 

Create a helper function that creates and ap... 
Make the .gitignore file more robust 

Add doc metadata 

We missed some AUTHOR additions 

Notes missing from CHANGELOG 

Added full version of the code of conduct 
change to link to the wiki 

Clarify license type, should make GitHub ha... 
Add the slow warning from lostdusty 

Update version in SECURITY.md for v2.4.0 
Tidying up since lines to follow documented ... 
Add missing tests 

More atomic.Value cleanups 

Add the basic code to implement the cloud p... 
Tidying up since lines to follow documented ... 
sort methods in canvasobject.go 

Add paste support to entry widget (++89) 


Add cloud interface for storage (docs) provis... 
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container: fix data race 

Fix 43113 Use lock in Container.Remove (+... 
Make Locale available from device interface 
Add support for setting a custom theme reso... 
Make the hardware info more open to expan... 
all: Reformat for Go 1.19 (more strict with go... 
Add notes to make sure that the code is not ... 
Remove flaky tests that made sure benchma... 
Switch naming to fyne.NewSquareOffsetPos 
Apply dependabot recommendation to develop 
Apply dependabot recommendation to develop 
move modifier key rune constants into widge... 
new constant fyne.KeyModifierShortcutDefault 
Switch from +build to go:build 

Minor godoc tweaks 

Add missed translation and documentation 
Improve error handling (++152) 

Improve error handling (++152) 

Move to float32 coordinates (++1661) 

Move to float32 coordinates (++1661) 

Merge branch 'develop' into feature/menuref... 
Just a few tests (canvas/circle 8 fyne.Menu) ... 
Add initial notifications support 

rename OverlayStack.All to List 

Add int float and bool lists too 

Improve naming, avoid Color vs ColorName ... 
Remove the now not needed Resource.Cac... 
Optimize the StaticResource.GoString() met... 
Fix an incorrectly placed constant 

Add ability to disable animations for widgets ... 
Since label for undo/redo shortcuts 

Replace empty interface with any type 

Fix usage of deprecated theme APIs 

Add missing docs 

Enable the TextStyle to be passed in as part... 
Tidying up since lines to follow documented ... 


Support custom icons in a Filelcon 
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Add new Since: docs to the APIs added in 1.4 
Update widget.go 


Add better documentation for the drop callback 
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About 


Fyne is an easy-to-use Ul toolkit and app API written in Go. It is designed to build applications that run on desktop and mobile 


devices with a single codebase. 


go documentation | release v2.5.0 
go report A+ |] C) Platform Tests failing | coverage 66% 


https://github.com/fyne-io/fyne 


4 years ago 


2 months ago 


last year 


Version 2.4 is the current release of the Fyne API, it added rounded corners, emoji, layout debug support and table headers, along 


with a large number of smaller feature additions. We are now working towards the next big release, codenamed Elgin and more 


news will follow in our news feeds and GitHub project. 


Prerequisites 


To develop apps using Fyne you will need Go version 1.17 or later, a C compiler and your system's development tools. If you're not 


sure if that's all installed or you don't know how then check out our Getting Started document. 


Using the standard go tools you can install Fyne's core library using: 


go get fyne.io/fyne/v2Q0latest 


Q 


After importing a new module, run the following command before compiling the code for the first time. Avoid running it before writing 
code that uses the module to prevent accidental removal of dependencies: 


go mod tidy 


Widget demo 


To run a showcase of the features of Fyne execute the following: 


go install fyne.io/fyne/v2/cmd/fyne_demoOlatest 


fyne_demo 


And you should see something like this (after you click a few buttons): 
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Or if you are using the light theme: 
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Getting Started 


Fyne is designed to be really easy to code with. lf you have followed the prerequisite steps above then all you need is a Go IDE (or a 
text editor). 


Open a new file and you're ready to write your first app! 


package main (O 


import ( 
"fyne.io/fyne/v2/app" 
"fyne.io/fyne/v2/container" 
"fyne.io/fyne/v2/widget" 


) 


func main() € 
a := app.New() 
w := a.NewwWindow("Hello") 


hello := widget.NewLabel("Hello Fyne!") 
w.SetContent(container .NewVBox( 
hello, 
widget.NewButton("Hi!", func() € 
hello.SetText("welcome :)") 
», 
)) 


w.ShowAndRun( ) 


And you can run that simply as: 


go run main.go (O 


O Note 


The first compilation of Fyne on Windows can take up to 10 minutes, depending on your hardware. Subsequent builds will be 
fast. 


It should look like this: 


000. 0090. 


Hello Fyne! Hello Fyne! 


Hi! Hi! 


Run in mobile simulation 
There is a helpful mobile simulation mode that gives a hint of how your app would work on a mobile device: 


go run -tags mobile main.go (O 
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Another option is to use fyne command, see Packaging for mobile. 


Installing 


Using go install will copy the executable into your go bin dir. To install the application with icons etc into your operating 
system's standard application location you can use the fyne utility and the "install" subocommand. 


go install fyne.io/fyne/v2/cmd/fyneWNlatest (O 
fyne install 


Packaging for mobile 


To run on a mobile device it is necessary to package up the application. To do this we can use the fyne utility "package" 
subcommand. You will need to add appropriate parameters as prompted, but the basic command is shown below. Once packaged 
you can install using the platform development tools or the fyne "install" subcommana. 


fyne package -os android -appID my.domain.appname (O 
fyne install -os android 


The built Android application can run either in a real device or an Android emulator. However, building for ¡OS is slightly different. If 
the "-os" argument is "ios", it is build only for a real ¡OS device. Specify "-os" to "¡ossimulator" allows the application be able to run in 
an ¡OS simulator: 


fyne package -os ios -appID my.domain.appname (O 
fyne package -os iossimulator -appID my.domain.appname 


Preparing a release 


Using the fyne utility "release" subcommand you can package up your app for release to app stores and market places. Make sure 
you have the standard build tools installed and have followed the platform documentation for setting up accounts and signing. Then 
you can execute something like the following, notice the -os ios parameter allows building an ¡OS app from macOS computer. 
Other combinations work as well :) 


$ fyne release -os ios -certificate "Apple Distribution" -profile "My App Distribution" -appID (O 
"com.example.myapp" 


The above command will create a '.ipa' file that can then be uploaded to the ¡OS App Store. 


Documentation 


More documentation is available at the Fyne developer website or on pkg.go.dev. 


Examples 


You can find many example applications in the examples repository. Alternatively a list of applications using fyne can be found at our 
website. 


Shipping the Fyne Toolkit 


All Fyne apps will work without pre-installed libraries, this is one reason the apps are so portable. However, if looking to support Fyne 
in a bigger way on your operating system then you can install some utilities that help to make a more complete experience. 


Additional apps 


lt is recommended that you install the following additional apps: 
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app 


fyne_settings fyne.io/fyne/v2/cmd/fyne_settings 


apps github.com/fyne-io/apps 


go install 


description 


These are optional applications but can help to create a more complete desktop experience. 


FyneDesk (Linux / BSD) 


To go all the way with Fyne on your desktop / laptop computer you could install as well :) 
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Cross-platform application for easy encrypted file, folder, and text 
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— FyneTerminal 


Cursor Row. 


https://github.com/fyne-io/fyne 


A GUI for managing your global Fyne settings like theme and scaling 


A graphical installer for the Fyne apps listed at 


O v2.5 introduces international support, system font lookup and completes Wayland and Web support (except file handling) 
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Packages 


No packages published 
Used by 1.5k 
AA LIABA 


Contributors 173 


23808: 10080 %-. 0 


+ 159 contributors 


Languages 


O Go95.7% 0 C1.3% 2 JavaScript 1.1% 0 Objective-C 1.1% 


O Java 0.4% 


O GLSL 0.2% 
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